Extensible Markup ) XML |آ‎ ga Jماعتلl كان‎ .Net Framework jn ةقبlwنlا في الإصدارات‎ 

eوuaوanا)‏ عملية بطيئة و صعبة و کان التعامل معها یتبع لما یسمی |۸۴ ۷3٣ 00M‏ (سنتكلم عنها 
لاحقاً) حيث كان على المبرمج في هذا ال املمم أن يقوم بإنشاء مستند 1× دائماً حتى و إن لم يكن لديه 
سوی عنصر 1× وحید و هذا يعرف با٣"‏ ce-entصuعه‏ و هذا من الأمور المزعجة فعلاً. 


بعد أن صدرت 3.5 )ا0س ع "ه٣۴‏ tمN.‏ اختفت معظم المشاكل السابقة في التعامل مع لغة 1× و أصبح 
من الممكن كتابة عناصر دون الحاجة إلى إنشاء مستند كامل أي ءأ ٠٣۲-٠"‏ ”ءام بالإضافة إلى 
الاستفادة من الأنواع المجهولة للمتحولات (ئممرا usرمصرمه”ه)‏ و إمكانية استخدام تقنية N۵‏ || مع 
عناصر ومستندات 01× أي أصبح إنشاء ملفات هذه اللغة و التعامل أسهل و أسرع من أي وقت مضى . 


حسناً لنبدأ الآن ببعض الأمثلة › لدينا ملف 01× التالي و سنحاول کتابته أولاً باستخدام |۸۴ 000 و من 
ثم باستخدام الصفوف التي توفرها لناه" || لنرى الفارق بينهما: 


<BookParticipants> 


<BookParticipant type="Author"> 


EQditor"> 


<FirstName>Joe</FirstName> 


<LastName>Rattz</LastName> 


</BookParticipant> 


<BookParticipant type="] 


<FirstName>Ewan</FirstName> 


<LastName>Buckingham</LastName> 


الملف باستخدام |۸۴ 00M‏ : 


</BookParticipant> 


</BookParticipants> 


XmlElement xmlBookParticipant; 
XmlAttribute xmlParticipantType; 


LFirstName; 


XmlElement xm 


XmlElement xmlLlLastName; 
First, I must build an XML document. 
XmlDocument xmlDoc = 


new XmlDocument () ; 


I'll create the root element and add it to the document. 
XmlElement xmlBookParticipants = 
emént ("BOOGKPAFELCILpAaNES") 
Doc.AppendChild (xmlBookParticipants) ; 
T"l1ll €rFéatée a participant and aãdd it to thé Book participants 


= xmlDoc.CreateElement ("BookParticipant"); 


xmlDoc.CreateAttribute ("type"); 


BookParticipant 
ParticipantType 


ML 
ML 


/ 


4 


/ 


1 


/ 


xmlDoc.CreateE 
M1 


x 
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1ParticipantType.InnerText = "Author"; 
1BookParticipant.Attributes. Append (xmlParticipantType) ; 
1FirstName = xmlDoc.CreateElement ("FirstName"); 
1FirstName.InnerText = "Joe"; 
1BookParticipant.AppendChild (xmlFirstName) ; 

1lLastName = xmlDoc.CreateElement ("LastName"); 
lLastName.InnerText = "Rattz"; 
1BookParticipant.AppendChild (xmlLastName) ; 
1BookParticipants.AppendChild (xmlBookParticipant) ; 

I'1l create another participant and add it to the book 
EEE 
1BookParticipant = xmlDoc.CreateElement ("BookParticipant"); 
1Participant1 = xmlDoc.CreateAttribute ("type"); 
1Participant1 .InnerText = "Editor"; 
1BookParticipant.Attributes.Append (xmlParticipantType) ; 
1FirstName = xmlDoc.CreateElement ("FirstName"); 
1IFirstName.InnerText = "Ewan"; 
1BookParticipant.AppendChild (xmlFirstName) ; 
lLastName = xmlDoc.CreateElement ("LastName"); 
1LastName.InnerText = "Buckingham"; 
1BookParticipant.AppendChild (xmlLastName) ; 
1BookParticipants.AppendChild (xmlBookParticipant) ; 


NN NNN MN NM N 


PaAFELGCIBaNES 
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الملف باستخدام N0‏ |1 : 


Element xBookParticipants = 
new XElement ("BookParticipants", 
new XElement ("BookParticipant", 
new XAttribute ("type", "Author"), 
Element ("FirstName", "Joe"), 
Element ("LastName", "Rattz")), 
Element ("BookParticipant", 
BEW XALEEIbDUTeE (TEYE, TEQLEGETP, 
new XElement ("FirstName", "Ewan"), 
new XElement ("LastName", "Buckingham"))); 
Console.Writeline (xBookParticipants.ToString ()); 


أعتقد أن الصورة لديكم الآن أصبحت واضحة أكثر .. لاحظوا صعوبة الكتابة بالطريقة الأولى بالإضافة إلى 
أنه من الصعب جداً توقع عناصر 11× التي ستنتج بينما في الطريقة الثانية سنكتب أسطراً أقل بالإضافة 
إلى أنه أصبح من الواضح جداً شكل الخرج الناتج. 


كما سبق و قلت في المقدمة فإنك إذا أردت إنشاء عنصر 1× وحید باستخدام W3C DOM model AP|‏ 
فإنك ستكون مضطراً إلى إنشاء مستند ۷1× جديد كما يلي : 


// With the original W3C DOM API, you could not simply create an XML element, 
XmlElement; you must 
// havé: an XML döocümenty, XmiDoceüment; EEOM WALE to €Ereate it: 


XmlDocument myXmlDoc = new XmlDocument () ; 
XmlElement xmlBookParticipant1 = myXmlDoc.CreateElement ("BookParticipant"); 


أما الآن مع Q‏ |1 فأنت غير مضطر لذلك و تستطيع إنشاء عنصر وحيد بسهولة : 
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// The new LINQ-enabled XML API allows you to instantiate an element itself 
without creating an XML document : 


XElement xeBookParticipant = new XElement ("BookParticipant"); 
حسنا و ماذا إذا كنا نريد مستند 11× و ليس عنصراً فقط ؟ المثال التالي سيجيب عن هذا التساؤل:‎ 


XDocument doc = new XDocument ( 
REW XDeclaFQaELOR (TLS OT, TOLE Ty. TIES 
new XComment ("Sample RSS Feed"), 
new XElement ("rss", 
Rew XAEtE1BDUtE ("VEéEEFSLON™", T20; 
new XElement ("channel", 
new XElement ("title", "RSS Channel Title"), 
new XElement ("description", "RSS Channel Description."), 
5 
XxX 


new XElement ("link", "http://aspiring-technology.com"), 
new XElement ("item" 
new XElemen 
men 
lemen 
lemen 


"ELELE™, TELES AEELECELE EILCLET 
TAESEEIPELORN", TELESEAFELELS DBESCETLBELON™ 
"pubDate", DateTime.Now.ToUniversalTime ()), 
"guid", Guid.NewGuid())), 


New XEL 


( 
( 
( 
( 
( 


new XJ 
new XJ 
Element ("item 
New XElemen 


پک کس پک ر 


O N LP 


4 
E (TELELê", TSeCONQA -SFELELe ELELE™D,; 
new XElement ("description", "Second Article Description"), 
new XElement ("pubDate", DateTime.Now.ToUniversalTime ()), 
new XElement ("guid", Guid.NewGuid () ) ) 


XDocument‏ لإنشاء مستند 1× جدید. 

lementاX×E‏ لإنشاء عنصر 1× جدید (قد یکون داخل عنصر آخر). 
X×X€omment‏ لإضافة التعليقات. 

XAttribute‏ لإضافة صفة لعنصر ما. 


قمنا بكتابة ملف 1× و لكن لن نستفيد شيئاً ما لم نكن قادرين على تخزينه و تحميله لاحقاً لذلك لتخزين 
الملف السابق نستخدم التابع Save‏ كما يلي : 


doc.Save (@"E:\file.xml"); 


كل ما نحتاجه هو تمرير المسار الذي نريد التخزين فيه إلى التابع مه5 . لاحظ أيضاً أن هذا التابع هو 
instance method‏ أي نستدعیه من أجل زط0 معین. 
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عندما نفتح الملف الذي حفظناه لتونا سنشاهد أنه قد تمت كتابته بتنسيق 1× الذي اعتدنا عليه و لكن يمكننا 
أن نلغي هذه الخاصية و نحفظ الملف كتسلسل نصي عادي و ذلك باستخدام ئ هام0 ۷ه و اختيار 
eFormattingاDisab‏ كما يلي : 


doc.Save (@"E:\file.xml", SaveOptions.DisableFormatting) ; 


<?xml version="1.0" encoding="utf-8" standalone="yes"?><! --Sample RSS Feed-- 
><rss version="2.0"><channel><title>RSS Channel Title</title><description>RSS 
Channel Description.</description><link>http://aspiring- 


technology.com</link><item><title>First article 
title</title><description>First Article 
Description</description><pubDate>2010-03- 
19T21:06:11.3073192</pubDate><guid>cel1l3e62b-fec4-4c89-88cc- 
bdf52127a4bf</guid></item><item><title>Second article 
title</title><description>Second Article 
Description</description><pubDate>2010-03- 
19T21:06:11.30931922</pubDate><guid>606ddb72-7806-4ed1-910d- 
95cd0eb5a0d9</guid></item></channel></rss> 


لا أعتقد أن أحداً يفضل شكل الملف هكذا ! حسنا لنعد قليلاً إلى المثال الأول عندما تكلمنا عن |۸۴ 000 و 
لنحاول طباعة الملف على الشاشة لنشاهد كيف سيكون الخرج و لنكتب : 


Console.Writeline (xmlDoc.ToString); 
الخرج‎ : ! ))٣|+۴5 حسناً لنعد إلى ثلاثة و ننفذ لنرى النتيجة :1 -2 -3 و‎ 


System. Xml. XmlDocument 


للأسف فإن استخدام ع" ٣‏ 5ه هنا لن يجدي نفعاً إذا لنحاول مع تابع آخر خاص بهذا الأمر : 


Console.WriteLlLine (xmlDoc.OuterXml) ; 


الخرج سيكون على النحو التالي : 


<BookParticipants><BookParticipant 
type="Author"><FirstName>Joe</FirstName><LastName>Rattz</LastName></BookParti 
cipant><BookParticipanttype="Editor"><FirstName>Ewan</FirstName><LastName>Buc 
kingham</LastName></BookParticipant></BookParticipants> 


أما لو عدنا ائ المتال التالي عندما کتبنا عناصر 1× باس ستخدام الصف gy XElement‏ حاولنا ایر ستخدام 
String‏ لإظهار النتائج سنحصل على النتيجة التالية : 


<BookParticipants> 


<BookParticipant type="Author"> 
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<FirstName>Joe</FirstName> 
<LastName>Rattz</LastName> 
</BookParticipant> 


<BookParticipant type="Editor"> 


<FirstName>Ewan</FirstName> 
<LastName>Buckingham</LastName> 
</BookParticipant> 


</BookParticipants> 
. لاحظ الاختلاف في تنسيق الملف‎ 
وهو تابع‎ |2١ هذا بالنسبة للحفظ أما بالنسبة لتحميل ملف 1× ما إلى برنامجنا سنقوم باستخدام التابعح‎ 


نهاك أي نستدعيه من أجل الصف و ليس من أجل كائن منه..بفرض أننا قمنا بإنشاء ملف في المشروع 
باسم ۲65۲۴1۵ و نريد تحميله الآن فإننا نكتب : 


XDocument xmlDoc1 = XDocument.Load ("TestFile.xml"); 


بالطبع فهنالك العديد من الخيارات أثناء تحميل الملف سنتكلم عنها لاحقاً. 


بالعودة قليلاً إلى الصف ×۴|٠ ٠١‏ سنجد أننا استخدمنا الباني الذي يأخذ وسطين » الأول يعبر عن اسم ال 
عه و الثاني يعبر عن المحتوى داخلها أي إذا أخذنا المثال التالي : 


Console.WritelLine (new XElement ("Name", "Hammod™") ); 


حيث سيكون الخرج : 
<Name>Hammod</Name>‏ 
أما إذا أردنا القيمة المحتواة في هذا العنصر فلن نحتاج أكثر من استدعاء التابع ںاج۷ : 


XElement name = new XElement ("Author", "Hammod") ; 
Console.WriteLine (name.Value) ; 


لننتقل الآن إلى ناحية أخرى في 1|۵ و لنفترض أنه لدينا مصفوفة مكونة من مئة اسم نريد كتابتها على 
شكل ملف 1× كما في المثال السابق تماماً . هذه عملية مضنية حقأً ! لذلك لابد من طريقة ما لكتابتها 
بسرعة و فاعلية و بأقل عدد ممكن من أسطر الكود» من المؤكد أنكم الآن تفكرون في الحلقات و لكن ما 
رأيكم بتجربة أمر آخر ؟ لنشاهد المثال التالي الذي يحوي أربعة أسماء و يمكن تعميمه لأعداد أكبر طبعاً : 


StFIRg[] names = { "M: Hammod", "Golden Man", "Mohammed 807"; "Nauwwa#f (musiê 
man)" }; 
XElement OurGroupMembers = new XElement ("OurGroup", 
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from n in names 
select new XElement ("Name",n)); 
Console.WritelLine (OurGroupMembers) ; 


لاحظوا ما الذى قمنا به » و كيف استطعنا بناء الملف باستعمال ماع مر فو فة الأسماء و النتيجة ال 
ي و کي من مصفو و النتيجة التي 
ا ي : 


<OUrGrOUP> 
me>M. Hammod</Name> 
me>Golden Man</Name> 


me>Mohammed 807</Name> 


me>Nawwar (music man) </Name> 


</OurGroup> 


لندخل في العمق قليلاً و لنفرض أننا قمنا بتغيير أحد الأسماء في المصفوفة بعد بناء الملف فما الذي 
سیحصل ؟ 


gtringl] names = { "M.Hammod™, "Golden Man"; "Mohammed 807", "Nawwazr (musie 
MEARJ™ FF 
XElement OurGroupMembers = new XElement ("OurGroup", 

from n in names 

select new XElement ("Name",n)); 


names [3] = "Mu Niza"; 
Console.WritelLine (OurGroupMembers) ; 


الخرج سيكون معتمداً على الإجابة عن السؤال التالي : متى يتم بناء الملف ؟ هل يتم بناؤه مباشرة أم يتم 
تأجيله ؟ الإجابة أننا عندما نستخدم الصف ٠ع‏ ء|٤×‏ يتم ذلك مباشرة لذلك لن يظهر أي تغيير في بنية 
الملف ٠‏ 
<OurGroup>‏ 
me>M. Hammod</Name>‏ 
me>Golden Man</Name>‏ 


me>Mohammed 807</Name> 


me>Nawwar (music man) </Name> 
</OurGroup> 


حسناً ما الحل إذا لتغيير بنية الملف باستعمال الكود السابق ؟ الحل ڊlږڌخدİ۾ xStreamingE1ement‏ بدلا من 
XElement‏ : 


XStreamingElement OurGroupMembers1 = new XStreamingElement ("OurGroup", 
from n in names 
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select new XElement ("Name", n)); 
names [3] = "Mu Nizar"; 
Console.WritelLine (OurGroupMembers1l); 


فا تحال غل اتر او كن اة 


<OUrGrOUP> 
me>M. Hammod</Name> 
me>Golden Man</Name> 


me>Mohammed 807</Name> 


me>Mu Nizar</Name> 


</OurGroup> 


كانت هذه مجرد مقدمة بسيطة عن ا۷¥× t0‏ 1N0ا‏ على الرغم من أننا لم نتنتحدث عن 1.11N@‏ 
خت الان و "تكن أ صبح لد صتا قكزة خد عقن امكاتية إتشاء مستتد ات ا¥ا× يبشهولة ٠‏ وى تشز 


تو اشطتها ٠و‏ الهدف أ نعلم 6 0 . لجسة. المجرد الاشستعلامات فعط: قي المزرة القادمة 


إن شاء لله سنتحدث بتفصيل أكبر عن 1[1N0‏ و نكتب أمثلة لتبين لنا فعالية التعامل مع 
ال ال۷× فقيها. 


Happy Programming! 


HammooD 2010-03-19 


m-khaled89@Ghotmail.com 
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